发布动态

Feature (2024-09-26)

描述: 整体优化相关接口文档的描述，使之更容易被接受和理解，增加新的相关设备的地图信息和地图的分区域信息

内容:

增加所有接口的调用示例（Demo）
我们为每个API接口新增了详细的调用示例，帮助开发者更好地理解和使用API。这些示例包括请求载荷（payload）和相应的响应示例。
新增获取机器人地图列表与站点区域获取接口
我们新增了两个与机器人地图相关的接口，以增强地图功能的交互性：
/openapi/v1/map/robotMap/list: 该接口用于获取机器人使用的地图列表，包括地图ID、地图名字的信息数据。
/openapi/v1/map/subareas/get: 该接口用于获取机器人地图中的分区信息，为需要更精确的机器人区域操作的服务提供了更大的细粒度控制。
调整 M/S 临时任务下发流程描述
我们对M线/S 的机器人临时任务下发接口的流程描述进行了调整，以提高接口的可读性。

描述: 设备状态&事件推送服务增强&任务报告查询及推送服务增强

内容:

机器人状态变更
新增内容：机器人状态接口已更新包括各类设备状态及其耗材寿命设备包括：滚刷、盘刷、左边刷、右边刷、软胶吸水扒、滚轮吸水扒、普通尘推、滚动尘推、过滤器、水阀
V2任务报告获取和任务推送变更
新增字段：以下字段已添加到 V2_ListRobotTaskReports 和 TaskReportPush 接口中。taskId（预部署组合任务ID）、planId（排班计划ID）、subTaskId（子任务ID）
事件推送服务变更
新增字段：IncidentPush 接口现在包含以下字段：taskId（预部署组合任务ID）、subTaskId（子任务ID）、taskInstanceId、taskName、mapId、mapName
数据源变更：这些字段的数据源已从数据拟合切换为机器端上报可能存在版本回退的情况在 AIO1.3 hotfix 之前这些字段可能为空
事件代码更新：对于事件代码 50001 和 50002推送消息中的事件名称将包含任务名称

描述: 事件推送服务增强

内容: 在事件推送服务中增加了聚合信息字段，包括事件发生时的机器人所在地图和任务名称等。这些新增字段为客户提供了更加全面的任务背景信息，使得事件推送更加有价值，帮助客户更好地理解和管理机器人的运行状态。

描述: 任务恢复能力优化

内容: 针对非AIO版本的Phantas，优化了其任务恢复能力。该优化提高了在非一体化系统环境下任务的可靠性和连续性，确保了任务执行的稳定性。

描述: 事件推送服务优化

内容: 优化了事件推送服务，打通了用户事件订阅和服务事件推送服务的数据关联关系。此改进使得用户能够更有效地订阅和管理各类事件通知，提升了事件处理的效率和用户体验。

描述: 新的任务报告接口

内容: 新增了任务报告接口v2alpha1/ListRobotTaskReports。该接口提供了更优的用户使用功能，使得用户能够更详细地获取和分析机器人的任务报告数据，从而提升了数据的可视化和决策支持能力。

描述: 无站点临时任务下发通道

内容: 增加了Phantas无站点临时任务下发通道（SendTempTaskCommand）。这一功能使得客户可以灵活地对机器人发布临时任务，无需依赖预先定义的站点，从而提升了任务调度的灵活性和效率。

描述: 初始化坐标类型优化

内容: 针对机器人移动指令在云端大小写导致的bug进行了修复，将初始化坐标类型从double优化为int。这一修复解决了因数据类型不匹配而引发的指令执行异常问题，确保了机器人移动的精准性和稳定性。

描述: 事件推送服务

内容: 新增任务开始推送和任务结束推送功能，使得客户可以更加清晰地了解机器人任务执行的动态变化。这一改进不仅增强了任务状态的可见性，也提高了客户对任务进程的掌握程度，从而能够更及时地进行相应的业务调整。